home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / games / pinfo.zoo / pinfo.txt < prev    next >
Text File  |  1992-12-01  |  14KB  |  397 lines
  1.  
  2.  
  3.  
  4. PINFO(1)                      Contributed Software                     PINFO(1)
  5.  
  6.  
  7. NAME
  8.        pinfo - play Infocom Inc. adventures
  9.  
  10. SYNOPSIS
  11.        pinfo [-aAehoOpstvV] [-c context] [-i indent] [-l lines] [-m margin]
  12.        [-r savefile] [display-flags] [datafile[.dat]]
  13.  
  14. DESCRIPTION
  15.        This program allows most of the popular Infocom text  adventures  to
  16.        be  played on your system. The games must be Standard Series for the
  17.        interpreter to function correctly; see the file INFOTBL.TXT  in  the
  18.        product release for full details on all Infocom games.
  19.  
  20.        The  -h  option will tell you what version of Z-Code Interpreter you
  21.        need for that adventure.  The informational  printing  options  (-h,
  22.        -o,  -O,  -v, and -V) will work with any adventure, but you won't be
  23.        able to actually play any games except for  Standard  Series  adven-
  24.        tures.
  25.  
  26.  
  27. OPTIONS
  28.        The command-line arguments allow for screen customizations, and also
  29.        various forms of cheating and/or debugging.
  30.  
  31.    Informational
  32.        These option will print information on the datafile to  the  screen.
  33.        If  any of these are given the game is not actually played, informa-
  34.        tion is just printed.
  35.  
  36.        Note that all these options except -h and -V will print  information
  37.        that  you  are not supposed to know: examination of this information
  38.        on a game you haven't  solved  could  seriously  detract  from  your
  39.        enjoyment of the game.
  40.  
  41.        -h     print the datafile header
  42.  
  43.        -o     print the object names, attributes and links
  44.  
  45.        -O     print the object tree
  46.  
  47.        -v     print the game vocabulary
  48.  
  49.        -V     verify  the game data file to ensure it hasn't been corrupted
  50.               (to get this same feature while playing use the $verify  com-
  51.               mand)
  52.  
  53.    Game Play
  54.        These  options  affect different aspects of game play.  Some of them
  55.        may definitely be considered  cheating  as  they  print  information
  56.        about the internals of the game as you are playing it.
  57.  
  58.        -a     display modifications to objects' attributes while playing
  59.  
  60.        -A     display value tests of objects' attributes while playing
  61.  
  62.  
  63.  
  64. Revision 3.0                    22 October 1992                               1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PINFO(1)                      Contributed Software                     PINFO(1)
  71.  
  72.  
  73.        -c context
  74.               set  the number of lines of context to keep at the top of the
  75.               screen when paging long output (default is 2)
  76.  
  77.        -e     echo each command before executing
  78.  
  79.        -i indent
  80.               set the number of spaces in the left margin (default  is  0).
  81.               Note  that  only  game  output  text  will be indented; input
  82.               prompts and input will not.
  83.  
  84.        -m margin
  85.               set the number of spaces in the right margin (default is 2)
  86.  
  87.        -p     don't page long output
  88.  
  89.        -P     set the alternate prompt flag (this flag is not used  in  all
  90.               games)
  91.  
  92.        -r savefile
  93.               causes  the  interpreter  to  restore the saved game savefile
  94.               after starting up.
  95.  
  96.        -s     don't print status line
  97.  
  98.        -t     display modifications of the object tree while playing
  99.  
  100.        -T     set the Tandy Licensing flag (this flag is not  used  in  all
  101.               games).   On  some  games  this  causes  printed  text  to be
  102.               slightly different.
  103.  
  104.  
  105. Interpreter Escape
  106.        Some of the above flags and options may also be modified during game
  107.        play via interpreter escapes.  Any command beginning with the escape
  108.        character (normally ``@'') is assumed to be  an  interpreter  escape
  109.        command.   The  current  commands  and their values may be listed by
  110.        giving just  the  escape  character  by  itself.   Current  commands
  111.        include:
  112.  
  113.        attr   Toggles the attribute printing variable (see -a above)
  114.  
  115.        echo   Toggles input line echoing (see -e above)
  116.  
  117.        pager  Toggles paged output mode (see -p above)
  118.  
  119.        prompt Toggles the alternate prompt (see -P above)
  120.  
  121.        status Toggles status line printing (see -s above)
  122.  
  123.        tandy  Toggles the Tandy license flag (see -T above)
  124.  
  125.        xfers  Toggles the object transfer flag (see -t above)
  126.  
  127.  
  128.  
  129.  
  130. Revision 3.0                    22 October 1992                               2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PINFO(1)                      Contributed Software                     PINFO(1)
  137.  
  138.  
  139.        Additional  escape  commands  may  be defined by individual terminal
  140.        interfaces; see below.
  141.  
  142. TERMCAP
  143.        This section gives information  specific  to  the  termcap  terminal
  144.        interface.   This  interface is for use with UNIX machines or others
  145.        with UNIX-compatible termcap or terminfo libraries.  In addition  to
  146.        termcap and terminfo it also supports the termio, termios, and sgtty
  147.        line-discipline libraries.
  148.  
  149.    Options
  150.        These options are in addition to the above, general options:
  151.  
  152.        -C file
  153.               Specifies a file of completion words.  If not given no  words
  154.               are  available  at  startup and any words defined during play
  155.               will not be stored.  Note pinfo must  be  compiled  with  GNU
  156.               Readline support to use this option.
  157.  
  158.        -H file
  159.               specifies a GNU Readline library history file to be used.  If
  160.               not given, history is not stored in a file.  Note pinfo  must
  161.               be compiled with GNU Readline support to use this option.
  162.  
  163.    Subshells
  164.        The TERMCAP version of the interpreter can invoke commands in a sub-
  165.        shell or an interactive subshell in the normal UNIX  fashion:  i.e.,
  166.        if a command's first character is an exclamation mark (bang) (``!'')
  167.        then the remainder of the command is passed verbatim to a  subshell.
  168.        If  there  is no text after the exclamation mark then an interactive
  169.        subshell is invoked.
  170.  
  171.        The value of the environment variable SHELL is used as the subshell,
  172.        or /bin/sh if SHELL doesn't exist or is empty.
  173.  
  174.        See  the  GNU Readline section for an exception when using GNU Read-
  175.        line.
  176.  
  177.    GNU Readline
  178.        The TERMCAP version of the interpreter contains optional support for
  179.        the  GNU  Readline  library.  This library allows input line editing
  180.        and history retrieval, including full incremental searching and csh-
  181.        style  command-line  editing.  By default the key bindings are those
  182.        of GNU Emacs, but the library is fully flexible and can  be  config-
  183.        ured to work in vi mode, or you can roll-your-own bindings.
  184.  
  185.        Because  csh-style  editing  uses  an  exclamation mark as the first
  186.        character for history substitutions, in order to get a subshell com-
  187.        mand (see above) you should escape the exclamation mark with a back-
  188.        slash (``\'') when using the GNU Readline library.  For example:
  189.  
  190.             >\!ls -l
  191.  
  192.        In addition to  the  standard  GNU  Readline  bindings,  the  single
  193.  
  194.  
  195.  
  196. Revision 3.0                    22 October 1992                               3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. PINFO(1)                      Contributed Software                     PINFO(1)
  203.  
  204.  
  205.        character command ?  will cause the interpreter to print the current
  206.        history list to the screen.
  207.  
  208.        See the GNU Readline manual for full details.
  209.  
  210.    Completion
  211.        If the GNU Readline library is being used, then completion is avail-
  212.        able by pressing the TAB key.  A list of all possible completions is
  213.        available by pressing TAB twice in a row.
  214.  
  215.        During normal game play the interpreter maintains a list of possible
  216.        words  to  complete  on.  This list is read in from a file specified
  217.        with -C (above) at startup and written out to that file at  the  end
  218.        of  the  game.   Modifications  to the list are possible via special
  219.        interpreter escape commands (see below).
  220.  
  221.        Filename complet